home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / doorware / horos003.zip / SYSOP.DOC < prev    next >
Text File  |  1995-12-28  |  19KB  |  380 lines

  1.                             Copyright (C) 1995
  2.                                 Don McNiel
  3.                             DataPlus Software
  4.                                 
  5.                                 DISCLAIMER
  6.  
  7.         The author has taken every precaution to insure that no harm
  8.         or damage will occur on computer systems operating this package.
  9.         Nevertheless, the author shall NOT be held liable for whatever
  10.         may happen on your computer system or to any computer systems
  11.         which connects to your own as a result of operating this package.
  12.         The user assumes full responsibility for the correct operation of
  13.         this software package, whether harm or damage results from software
  14.         error, hardware malfunction, or operator error. NO warranties are
  15.         offered, expressly stated or implied, including without limitation
  16.         or restriction any warranties of operation for a particular purpose
  17.         and/or merchantability.  If you do not agree with this then do NOT
  18.         use this program.
  19.  
  20.                                 LICENSE AGREEMENT
  21.  
  22.         The game program, support files, and documentation are copyrighted
  23.         products of Don Mcniel.  Don McNiel reserves all rights to
  24.         these products. This is protected by the United States of America
  25.         (USA) and International Copyright Laws. In no way shall the
  26.         components of the game software package be reproduced or modified
  27.         in any form or method without prior expressly written permission
  28.         from Don McNiel.
  29.  
  30.         A major portion of this software comes from the DDPlus Door Driver
  31.         Package and was written by the authors of that package. The DDPlus
  32.         Doordriver kit has been used for the communications, interrupt
  33.         handling and some utility functions and that part of the software
  34.         remains copyrighted by the authors of the DDplus Package.
  35.  
  36.         This game is distributed under the Shareware concept. You are
  37.         allowed to operate this game for a trial period of thirty (30)
  38.         days. After this trial period, you must register the game 
  39.         or discontinue its usage. Again if you do not agree with this
  40.         then do NOT use this utility.
  41.  
  42.                                 INTRODUCTION:
  43.                                 ------------
  44.         
  45.         In here goes a general description and summary of your door
  46.         product. Try to keep it to one or two paragraphs only.
  47.                                 
  48.                                      
  49.  
  50.                                 REQUIREMENTS:
  51.                                 ------------
  52.         At this point in time the only requirements are FILES=10 (or more)
  53.         in your config.sys file and ANSI.SYS. SHARE must also be loaded IF
  54.         you intend to use the game in a multi-node environment OR under
  55.         DesqView. The util is RIP aware but NOT a RIP util at this time. A
  56.         FOSSIL is NOT required to run the game, although one will be
  57.         supported if it exists. Automatic time slicing support is provided
  58.         to most common multi-taskers as well.
  59.  
  60.                                 Files Included
  61.                                 --------------
  62.         Below is a listing of all files for the this Game.  If you are
  63.         missing ANY of these files (except for the DOC and FRM files), the
  64.         game will NOT function.  Feel free to give out copies of the ENTIRE
  65.         archive package of this game but please make sure all the files
  66.         below are in that package:
  67.  
  68.         FILE_ID.DIZ  - Ascii Description File for BBS Sysops 
  69.         WHATSNEW.DOC - Version History information file
  70.         SYSOP.DOC    - This text file you are reading
  71.         BUGRPT.FRM   - Preprinted bug report/suggestion/comment form
  72.                         and mailer.
  73.         ERROR.LOG    - Created by main program if error occurs
  74.  
  75.  
  76.         7. In order to run the game program online the following
  77.            parameters may be used.
  78.  
  79.         "/Bxxxxx"   This tells GAME.EXE to lock its baud rate at
  80.         xxxxx.  In order to get the most efficiency out of a high speed
  81.         error correcting modem (9600 baud or above), you may lock the baud
  82.         rate to a speed higher than what the caller is actually using.
  83.         By locking the baud to say 38,400, the modem can compress text data
  84.         that is being sent and achieve a baud rate much higher than the
  85.         actual transmission rate.
  86.         This will lock the baud rate at the same value for all nodes that
  87.         use this command line.  If you perfer a more selective way to lock
  88.         baud use 'LOCKBAUD' command in the GAME.CTL file.
  89.  
  90.         "/Cx"     (where x is 1..4) This specifies a comport number.
  91.         Some bbs software does not create door information files (dropfiles)
  92.         that contain the comport number.  If your bbs does have a comport
  93.         listed in the dropfile then there is no need for this parameter.
  94.         The default is comport 0, local mode.
  95.  
  96.         "/E" - Expanded Memory Specification If your machine has over one
  97.         megabyte of memory, then you may have some available.  GAME.EXE can
  98.         utilize EMS to improve game performance and reduce conventional
  99.         memory requirements.
  100.         This command will tell GAME.EXE   to use EMS memory to hold its
  101.         overlay buffer.  Otherwise disc area may be used to hold this buffer.
  102.         This needs a memory manager and when enabled and is compatible with
  103.         DESQview. Default is NOT to use available EMS.
  104.  
  105.         "/F"      This is a generic maintenance mode. It logs
  106.         into the game with the name "SYSTEM MAINTENANCE" in local mode.
  107.  
  108.         "/H"      This is a generic maintenance mode. It logs
  109.         into the game with the name "SYSTEM MAINTENANCE" in local mode.
  110.  
  111.         "/L"      This tells GAME.EXE to load up in LOCAL mode.
  112.         This is good for testing or when a sysop just wants to "try out" the
  113.         door without messing with his BBS setup.  The "/L" mode will ask the
  114.         user for his name and run the door in local mode.
  115.  
  116.         "/Nx"     (where x is 1..9) This specifies a "node number".
  117.         Some bbs software support multinode environments in which you must
  118.         know the node number of the drop file to use. For example, RBBS-PC
  119.         uses DORINFOx.DEF. If you specified "/N2" then GAME.EXE would use
  120.         DORINFO2.DEF.
  121.  
  122.         "/Mx"     (where x is up to 2 filename acceptable characters)
  123.         Used to specify one of Multiple control files.  If you have created
  124.         more than one GAME.CTL file (GAME1.CTL, GAME2.CTL, etc.) for each
  125.         node or network PC then you can select the one you want by using
  126.         the /M parm.
  127.         Example:  "/M2" will force GAME.EXE to use GAME2.ctl.
  128.  
  129.         "/Pyyy"   This specifies the path to the drop files.
  130.         For example, "/PC:\WILDCAT\WCWORK\NODE1" would tell GAME.EXE to
  131.         look for the drop file in C:\WILDCAT\WCWORK\NODE1. If this is left
  132.         out the program assumes the drop file is local.
  133.  
  134.         "/R" To force local RIP for the sysop. Used only if the program
  135.         has RipLink built in and the door supports RIP.  Use AFTER the
  136.         /L parameter if you are using the door in local mode.
  137.         
  138.         "/V"    This command will tell GAME.EXE not to show any display
  139.         on the local screen.  Only a colored screen and a message will be
  140.         displayed.  The cursor will not move as it will be turned off.
  141.         Saves a little processing on multi-tasking systems.
  142.  
  143.         "/W"      This flags the program that a network is present even
  144.         though no multitaskers are detected.  This is useful if the door is
  145.         run on a network such as Novell that doesn't use multitaskers.
  146.  
  147.  
  148.             COMMON ERRORS
  149.             003  File path not found. Check to make sure the game
  150.                  directory is correctly named as GAMEDIR.
  151.             201  Files not found. Check to make sure that all required
  152.                  games files are in the GAMEDIR directory.
  153.  
  154.         8. Install the door into your BBS software (see your BBS
  155.            software documentation for more information).  A batch file is
  156.            normally used to do this.  To run the program just have your
  157.            batch file change to the GAMEDIR directory and run GAME.EXE -
  158.            Thats all there is to it!  Three different batch files sample
  159.            are included to help you run the game. These are included with
  160.            the game for editing and your use. Remember when writing the
  161.            batch routines for my games you must ensure that the game is
  162.            run from it's home directory AND that the game knows where to
  163.            find the drop file.  Satisfy these two requirements and you
  164.            should have no problems running the game as long as the other
  165.            setup criteria has been met. For dorinfo systems try using the
  166.            following: 
  167.  
  168.                             Sample Batch File
  169.                             -----------------
  170.            
  171.                  COPY DORINFOx.DEF \RBBS\DOORS\GAMEDIR\*.*
  172.                  CD \RBBS\DOORS\GAMEDIR
  173.                  GAME x <-=- NODE number !!DO NOT USE "x"!!
  174.                  del dorinfox.def            
  175.                  CD \WC30
  176.  
  177.             -->  Please note that you replace the "x" with the appropriate
  178.                  node number. Ex: Dorinfo1.def ; Dorinfo2.def ; etc...
  179.  
  180.  
  181.         9.  If you would like a score bulletin just have the game
  182.             batch file copy the *SCORE.DAT file to wherever you have your
  183.             bulletins. Example:
  184.             
  185.             Copy C:\WC30\DOORS\GAMEDIR\*SCORE.DAT C:\WC30\BULL\BULL11.BBS
  186.  
  187.             Please note that NO *SCORE.DAT file will be generated UNTIL a
  188.             player completes a game and has better then a zero (0) score.
  189.             If the first player quits BEFORE finishing the game the file
  190.             will not be created.
  191.  
  192.         10. If you would like the news file to become a bulletin just
  193.             have the game batch file copy the NEWS.DAT and/or OLDNEWS.DAT
  194.             file to wherever you have your bulletins.  Example:
  195.             
  196.             Copy C:\WC30\DOORS\GOC\NEWS.DAT C:\WC30\BULL\BULL12.BBS
  197.  
  198.         11. Surprise!  There is NO separate daily maintenance to be
  199.             performed. The first player of each day will automatically run
  200.             the built in maintenance routines.
  201.  
  202.  
  203.                          WHAT TO DO IF THERE ARE PROBLEMS
  204.                          --------------------------------
  205.  
  206.         Every effort is made to ensure that the game runs correctly
  207.         before it leaves my BBS as Shareware.  If you are experiencing
  208.         problems please do the following BEFORE calling me:
  209.  
  210.         1.  Read ALL the SYSOP.DOC to ensure you have setup the program
  211.             and have met all the program requirements.
  212.  
  213.         2.  Use the B4UASK.DOC as a checklist to ensure that you have
  214.             not done anything wrong.
  215.  
  216.  
  217.                                   Multinode use
  218.                                   -------------
  219.         This game supports multinode use and provides automatic
  220.         multi-tasker support  (time slice releasing) for a wide variety
  221.         of multi-taskers.
  222.  
  223.                Common Problems (Locked Bauds, High Speed modems, etc)
  224.                ------------------------------------------------------
  225.  
  226.         1.   The game does NOT require a fossil driver to run.
  227.  
  228.         2.   If you are running a high speed modem (9600 baud or above),
  229.              then I suggest you run your bbs/mailer/doors at a locked baud
  230.              rate. On high speed error correcting modems, locking the baud
  231.              rate will have a noticeable increase on the speed of text that
  232.              is sent. It's beyond the scope of this document to discuss
  233.              configuring your BBS and mailer for a locked baud rate; you may
  234.              wish to consult those docs for information on that. Here are a
  235.              few things to keep in mind when setting up GAME with a locked
  236.              baud rate:
  237.  
  238.              a.  When using a locked baud rate, I highly recommend
  239.                  using a  FOSSIL driver. This game will work at high
  240.                  speeds without one though. BNU is a good fossil driver
  241.                  which can even be loaded and unloaded before and after
  242.                  you run this game.
  243.  
  244.              b.  If you are using a fossil, then make sure to tell the
  245.                  fossil that the port is locked. For BNU, to lock com1:
  246.                  at 38,400, you would use something like "L0=38400" on
  247.                  BNU's command line.
  248.  
  249.              c.  If you lock the baud for one program, it must be
  250.                  locked for everything. You can't lock the baud for just
  251.                  this game, but not your BBS/mailer.
  252.  
  253.              d.  You may need to use the /B switch on the game.exe
  254.                  Command line to specify the locked baud rate. For
  255.                  19,200 this would be "/B19200" and for 38,400 this
  256.                  would be "/B38400". Please note there is no space
  257.                  between the "/B" and the baud rate.
  258.  
  259.         3.   What follows is some information on possible strange
  260.              situations that may occur:
  261.  
  262.              a.  Low speed users can play the game, but high speed
  263.                  users get garbage.
  264.      
  265.                  - If you are not using the DORINFOx.DEF or
  266.                    DOOR.SYS drop file then you may wish to find a
  267.                    converter program to convert whatever drop file
  268.                    your BBS produces to the DORINFOx.DEF or DOOR.SYS
  269.                    format and tell game.exe to use that.
  270.  
  271.                    Several converter programs are readily available
  272.                    on most BBS systems. CallDoor is a good one if you
  273.                    can find it. I have it on my BBS for download if
  274.                    you need it.
  275.  
  276.              b.  The game hangs up when a user enters the game.
  277.  
  278.                  - Sounds like the game is getting the wrong baud
  279.                    rate somehow. Try switching over to the DOOR.SYS
  280.                    drop file method if possible.
  281.  
  282.              c.  Text and screens are getting cut off.
  283.  
  284.                  - If you are running with a locked baud, then this
  285.                    could be caused by some sort of FLOW CONTROL
  286.                    problem. Try using a fossil if you aren't already.
  287.  
  288.              d.  If you're using something other than the DOOR.SYS
  289.                  drop file, then I always suggest trying to use
  290.                  DOOR.SYS if possible. It is the most reliable method
  291.                  and has had the most testing. If that is not possible
  292.                  try DORINFOx.DEF as an alternative.
  293.  
  294.              e.  A door locks up node 1.  This can happen with fossils
  295.                  or the internal communications routines because it
  296.                  uses the default comport of 1 when NONE is found in
  297.                  the dropfile or game.ctl file. To correct this make
  298.                  sure the right port is shown in the dropfile OR
  299.                  game.ctl file.
  300.  
  301.              f.  ANSI is reflected correctly on the local screen but
  302.                  the user is getting garbage.  Assuming the user has
  303.                  ANSI installed then most likely the problem is at
  304.                  your end. First make sure you have configured the 
  305.                  game.ctl file to show the correct locked port rate.
  306.                  Second make sure the dropfile is passing the locked
  307.                  port rate INSTEAD of the actual conncet rate.  If it
  308.                  is not passing the locked port rate then you may
  309.                  need to use a different dropfile format OR use a
  310.                  dropfile converter program to change the line to
  311.                  show the locked port rate INSTEAD of the actual
  312.                  connect rate.
  313.  
  314.                     
  315.                                  CREDITS:
  316.                                  --------
  317.         This relatively small section is just to recognize the
  318.         GOOD people  who have made this door a possibility.
  319.  
  320.         The DDPlus Team - Thanks to Scott Baker, Steve Lorenz,
  321.                           Bob Dalton, Andy Stewart, Tom Morgan
  322.                           and other contributors for that great
  323.                           turbo pascal door kit.  If you ever
  324.                           want to make a door product for use
  325.                           with BBS's then this is the kit to get!
  326.         
  327.         DESQview is a registered trademark of Quarterdeck Office Systems.
  328.         Doordriver kit is proprietary software by Scott Baker.
  329.         Ripscript & Ripterm are registered trademarks of TeleGrafix
  330.         Communications.
  331.  
  332.                                Where to reach me
  333.                                -----------------
  334.  
  335.         I can usually be reached at my BBS system, which should be
  336.         listed in the section entitled "registration" which is below.
  337.         I also habitually monitor ALL door related echos in the FIDO
  338.         Net System.
  339.  
  340.  
  341.                                   Registration
  342.                                   ------------
  343.         If you or your users enjoy this game, then please register it.
  344.         Information on price and how to register is shown on the
  345.         enclosed REGISTER.FRM.  Registration will disable the delay,
  346.         allow additional options and entitle you to life time support
  347.         through my BBS.  BBS Support includes unlimited free updates
  348.         and upgrades (not like some door game authors who charge for
  349.         major upgrades/updates!) through my BBS and access to the game
  350.         support conference on my BBS.  To register this game just print
  351.         out the registration form (REGISTER.FRM) file included with the
  352.         game and  send it with your check or money order to:
  353.                     
  354.  
  355.  
  356.                            HOW TO REACH ME BY MODEM
  357.                            ---------------------------
  358.  
  359.                              Rad Shak! BBS (USA)
  360.                 (316) 524-8707  (USR v.Everything - 2400 to 28800 baud)
  361.                 (316) 524-0405  (USR v.Everything - 2400 to 28800 baud)
  362.                                Fidonet 1:291/39
  363.  
  364.  
  365.                         Bug Reports/Comments/Suggestions
  366.                         --------------------------------
  367.         I have made every attempt to make sure the game is free of bugs,
  368.         BUT the possibility always exists that one may have been missed
  369.         by me or the playtesters.  If you find a bug, or have a
  370.         suggestion or comment to make which would make future versions
  371.         better please print out the BUGRPT.FRM and mailer, fill it out,
  372.         and send it to me.  I read ALL of them and those people that
  373.         lead me to find a bug or generate a better game will receive
  374.         credit in the game documentation. PLEASE DO NOT NOTIFY ME OF
  375.         PROBLEMS AND EXPECT ME TO FIX THEM IF YOU HAVE FAILED TO
  376.         PROVIDE ME WITH THE BUGRPT.FRM AND OTHER INFORMATION I REQUIRE
  377.         AS STATED IN THE B4UASK.DOC.
  378.  
  379.  
  380.